home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / CHAMBERS / FREEPING / !FreePing / !Help < prev    next >
Text File  |  1998-04-19  |  5KB  |  106 lines
  1. === !FreePing Help File
  2.  
  3. Motivation
  4.  
  5. If you do not know what "ping" is or how to use it stop now. You will
  6. be wasting your time.
  7.  
  8. I wanted to have an implementation of ping which did not lock up the
  9. WIMP even in a TaskWindow. I do not care about flood functions or anything
  10. much to do with ethernets. I just wanted to check if nodes are up and how long
  11. packets take to make a round trip because the internet is so flaky and changes
  12. so much that *something* is always down.
  13.  
  14. Health Warning
  15.  
  16. !FreePing is blacksmithed code. It is ancient code from the days of UNIX soldered
  17. onto a pedagogical RISC-OS application using a collection of freeware libraries.
  18. The building is done with Acorn Desktop C version 4. It probably should be done
  19. with Toolbox and C++ (or Java and JDK-Classlib or Ada95 and an old windsock).
  20. But it isn't because I will not pay money for something cobbled together with
  21. cfront - neither at work and certainly not at home.
  22.  
  23. It works. On my machine using Internet 5.02 with RO3.70. If it does not work
  24. for you remember the advice from Zen and the Art of Motorcycle maintenence,
  25. "For assembling the item great peace of mind is required."
  26.  
  27. It it fails you then given the nature of pinging you are probably using
  28. a stressed system. If you are going to write a problem report to the e-mail
  29. at the bottom of the helpfile then decide if you have the time to re-run
  30. a test in a calmer state of mind and log the results OR hey, maybe it's
  31. not worth bothering. It's free and you probably want to do what you were
  32. doing when it went wrong. !FreePing is supplied "as is" and is not warranted
  33. to function on any particular machine. Also using !FreePing does not imply
  34. any liability for consequential damages.
  35.  
  36. Copyright
  37.  
  38. The software !FreePing is Copyright © Peter Chambers 1998.
  39. Certain parts and libraries have copyrights from other authors whose
  40. copyright does not preclude inclusion.
  41.  
  42. !FreePing is FREEWARE and may be used by anyone. It may be distributed
  43. freely by non-profit means. If a fee is charged for copying it that fee
  44. must be strictly to cover the costs of the copying process. All copying
  45. and distribution must be of the whole software including all relevent
  46. notices, credits and documentation.
  47.  
  48. It must not be sold for commercial gain or distributed as part of a
  49. "cover disc" or profit making software library without the permission of
  50. the author. In the interests of users distribution by on-line means is
  51. preferred and attempts will be made to ensure the latest version is available
  52. on-line.
  53.  
  54. Credits
  55.  
  56. The basic function of !FreePing is based on the NetBSD ping.c ported to RISC-OS
  57. by Tom Hughes who seems to have written much of the RISC-OS freeware starting
  58. with FreeNet (though others are now following his sterling example).
  59.  
  60. The application skeleton is based (a lot!) on Client_Ex by Duncan Ferguson.
  61. Duncan took the attitude that other authors could make what they wanted of it.
  62. I used it to learn how to hack network applications under a dozy GUI. Thanks.
  63.  
  64. The look'n'some'of'feel and the sprites come from !Ping by Tim Howarth which
  65. is a front end for the command line ping. I lifted the idea of the Most Recently Used
  66. hostnames from !Ping. Tim encouraged me to just get on with it and replace !Ping
  67. with !FreePing in the interests of the users. He also strongly advocated using BASIC
  68. as the size of the runimage is small. Even with the Best Basic In The World I had to
  69. write it in C as the sight of lines like "block!8=&0700008" brings on the red mist.
  70. Tim also changed the Templates to be a bit neater.
  71.  
  72. The next layer down is the ShellLib by Julian Smith which I needed for the output
  73. window. This uses DeskLib also by Julian. He took the same helpful attitude as
  74. the others are replied promptly to my news plea when I found that DeskLib had
  75. no "txt" element.  One day the ghosts of RiscOS-lib will be finally laid.
  76. Until that time free libraries like this which have what programmers actually
  77. use will be our stopgap.
  78.  
  79. The network interface is provided by NetLib which has the names of Andy Mell
  80. and Stewart Brodie in it's credits. Long ago they tried to explain to me why RiscOS
  81. cannot use "close()" for sockets. Stewart used the word "disjoint" to explain.
  82. This does not detract from the immense value they have given Acorn programmers
  83. in NetLib. Since it matches the interface is Comer and Stevens straight from
  84. the box that's the one that got used. I gather that Adam Goodfellow did the
  85. "gettimeofday()" function which cannot quite guarantee the microseconds so
  86. the time results get granularised in the code (which should always have been
  87. possible).
  88.  
  89. History
  90.  
  91. 0.05 First open beta release.
  92.  
  93. 0.04 Properly fixed re-init of timing variables, trimmed wimpslot.
  94.  
  95. 0.03 Added text window save function in menu.
  96.  
  97. 0.02 Changed templates (courtesy T.Houghton), fixed close gadget,
  98.      removed blank line at end of !Run.
  99.  
  100. 0.01 improved LRU code, added timing granularity, tried close on textwin (failed)
  101.  
  102. 0.00 First written with basic functionality. Not released yet.
  103.  
  104. Author
  105.  
  106. Peter Chambers         mailto:  freeping@hightown.demon.co.uk